home *** CD-ROM | disk | FTP | other *** search
/ IRIX Installation Tools & Overlays 1999 May / SGI IRIX Installation Tools & Overlays 1999 May - Disc 2.iso / relnotes / performer_eoe / ch2.z / ch2
Text File  |  1999-04-19  |  15KB  |  396 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists information supplemental to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed here is
  12.        product-specific; use it with the Installation Guide to
  13.        install this product.
  14.  
  15.  
  16.        2.1  _P_r_e_r_e_q_u_i_s_i_t_e_s
  17.  
  18.  
  19.        To use IRIS Performer 2.2.5 your system must be running IRIX
  20.        6.5.4m or 6.5.4f.
  21.  
  22.        IRIS Performer 2.2 supports all graphics configurations that
  23.        are running at least IRIX 6.2.  In order to run MIPS-III/IV
  24.        applications you must install the appropriate selection of
  25.        N32 and N64 subsystems as listed.  In IRIX 6.5 and later,
  26.        N32 is the standard system default.
  27.  
  28.        IRIS Performer is also dependent on the general system
  29.        configuration so there are things outside of the IRIS
  30.        Performer 2.2.5 distribution that you will need.  If you are
  31.        running IRIX 6.2, 6.3, or 6.4, we categorically recommend
  32.        installing the latest recommended patch set.  If you are
  33.        running IRIX 6.5 or above, we recommend loading the latest
  34.        IRIX maintenance overlay.  IRIS Performer developers will
  35.        also need a C or C++ compiler, the loader, and associated
  36.        software development tools.
  37.  
  38.  
  39.        2.2  _I_R_I_S__P_e_r_f_o_r_m_e_r__E_O_E__S_u_b_s_y_s_t_e_m_s
  40.  
  41.        Many subsystems comprise the IRIS Performer execution
  42.        environment distribution.  These subsystems are not all
  43.        required for a proper installation.
  44.  
  45.        This release includes OpenGL and IRIS GL versions of the
  46.        GL-specific Performer libraries.  It also spans two machine
  47.        architecture levels -- the 32-bit MIPS I/II instruction set
  48.        and the 64-bit MIPS III/IV instruction set -- along with two
  49.        versions of 32-bit support -- the old caller-save register
  50.        management protocol known as Old-32 (O32 is used by IRIX 5
  51.        programs) and the newer callee-save register management
  52.        protocol termed New-32 (N32) -- there are actually three
  53.        versions of each library: O32, N32, and N64.  The 'file'
  54.        IRIX shell command can tell you what version of the MIPS
  55.        instruction set is being used by a given executable.
  56.  
  57.        This multidimensional complexity is hidden from software
  58.        developers using IRIS Performer since the APIs are unchanged
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        between the versions.  However at installation you must
  75.        choose which is appropriate for you.
  76.  
  77.        The subsystem naming conventions are designed to be simple
  78.        and regular:
  79.  
  80.           +o Old-32 32-bit mips-2 are in ".swO32" subsystems.  These
  81.             were the standard IRIX 6.2 libraries and are now
  82.             provided only for compatibility on IRIX 6.2.  They will
  83.             be automatically selected for installation only if you
  84.             are upgrading from a previous version of IRIS Performer
  85.             and had the Old-32 32-bit mips-2 libraries previously
  86.             installed.  Otherwise, the O32 subsystems are not
  87.             selected by default.  We recommend using N32 for better
  88.             performence, even on IRIX 6.2.
  89.  
  90.           +o New-32 32-bit libraries are in ".sw32" subsystems.
  91.             These are only usable on IRIX 6.2 and later operating
  92.             system releases. N32 operates at increased efficiency
  93.             in many situations.  N32 is the default mode of
  94.             operation in Performer2.2.5.
  95.  
  96.           +o New-64 64-bit libraries are in ".sw64" subsystems.
  97.  
  98.           +o OpenGL libraries have ".ogl" subsubsystem name
  99.             components and IRIS GL libraries have ".igl"
  100.             subsubsystem name components.  For best performance, we
  101.             recommend you use the OpenGL-based IRIS Performer
  102.             libraries on systems which provide native support for
  103.             OpenGL:  All systems containing InfiniteReality-class
  104.             graphics hardware, all Indigo2 Impact systems, all
  105.             Octane systems, all O2 systems, and all future graphics
  106.             systems.
  107.  
  108.             Use of IRIS GL programs on these systems implies a
  109.             run-time compatibility mode mechanism (IGLOO) that can
  110.             not attain optimal performance.  The IRIS GL-based IRIS
  111.             Performer libraries are intended for the older SGI
  112.             graphics platforms: the RealityEngine family
  113.             (RealityEngine, RealityEngine2, VTX), the Express
  114.             family (XS, XS24, XZ, Elan, and Extreme), and the Indy
  115.             family (XL, 8-bit Indy, and 24-bit Indy).
  116.  
  117.  
  118.           +o Only the optimized libraries are included in the
  119.             execution environment.
  120.  
  121.        A few simple examples should make the naming conventions
  122.        clear:
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.           +o performer_eoe.swO32.ogl_performer: O32 (mips-2),
  141.             OpenGL, Optimized, DSO
  142.  
  143.           +o performer_eoe.swO32.igl_performer: O32 (mips-2), IRIS
  144.             GL, Optimized, DSO
  145.  
  146.           +o performer_dev.sw32.ogl_performer: N32 (mips-3), OpenGL,
  147.             Optimized, DSO
  148.  
  149.           +o performer_eoe.sw32.igl_performer: N32 (mips-3), IRIS
  150.             GL, Optimized, DSO
  151.  
  152.           +o performer_eoe.sw64.performer:  N64 (mips-4), OpenGL,
  153.             Optimized, DSO
  154.  
  155.           +o performer_dev.sw32.ogl_debug_performer: N32 (mips-3),
  156.             OpenGL, Debug, DSO
  157.  
  158.           +o Note that this example illustrates a subtlety not
  159.             mentioned in the rules above -- since only OpenGL is
  160.             supported in 64-bit modes, all GL-specific 64-bit
  161.             subsystems are inherently OpenGL in nature.
  162.  
  163.        Included in the the full IRIS Performer distribution are
  164.        these subsystems, whose names were composed following the
  165.        conventions outlined above:
  166.  
  167.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._d_a_t_a
  168.             Sample Data and Fonts
  169.  
  170.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._t_o_w_n
  171.             The Performer Town demo data
  172.  
  173.        _p_e_r_f_o_r_m_e_r__d_e_m_o._m_a_n._d_e_m_o
  174.             Reference pages for demo programs
  175.  
  176.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_3_2._i_g_l__d_e_m_o
  177.             Demo executables (n32, IRIS GL)
  178.  
  179.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_3_2._o_g_l__d_e_m_o
  180.             Demo executables (n32, OpenGL)
  181.  
  182.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_6_4._d_e_m_o
  183.             Demo executables (n64, OpenGL)
  184.  
  185.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_O_3_2._i_g_l__d_e_m_o
  186.             Demo executables (o32, IRIS GL)
  187.  
  188.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_O_3_2._o_g_l__d_e_m_o
  189.             Demo executables (o32, OpenGL)
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_O_3_2._p_e_r_f_o_r_m_e_r_1__2
  207.             Performer 1.2 Compatibility DSOs
  208.  
  209.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_O_3_2._p_e_r_f_o_r_m_e_r_2__0
  210.             Performer2.0.7 [2.0-2.0.6] Compatibility DSOs (o32)
  211.  
  212.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_3_2._p_e_r_f_o_r_m_e_r_2__0
  213.             Performer2.0.7 [2.0-2.0.6] Compatibility DSOs (n32)
  214.  
  215.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_6_4._p_e_r_f_o_r_m_e_r_2__0
  216.             Performer2.0.7 [2.0-2.0.6] Compatibility DSOs (n64)
  217.  
  218.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_O_3_2._p_e_r_f_o_r_m_e_r_2__1
  219.             Performer2.1.5 [2.1-2.1.4] Compatibility DSOs (o32)
  220.  
  221.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_3_2._p_e_r_f_o_r_m_e_r_2__1
  222.             Performer2.1.5 [2.1-2.1.4] Compatibility DSOs (n32)
  223.  
  224.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_6_4._p_e_r_f_o_r_m_e_r_2__1
  225.             Performer2.1.5 [2.1-2.1.4] Compatibility DSOs (n64)
  226.  
  227.        _p_e_r_f_o_r_m_e_r__e_o_e._m_a_n._r_e_l_n_o_t_e_s
  228.             Performer Release Notes
  229.  
  230.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._c_o_m_m_o_n__p_e_r_f_o_r_m_e_r
  231.             Performer GL-independent DSOs (n32)
  232.  
  233.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._i_g_l__p_e_r_f_o_r_m_e_r
  234.             Performer IrisGL DSOs (n32)
  235.  
  236.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._o_g_l__p_e_r_f_o_r_m_e_r
  237.             Performer OpenGL DSOs (n32)
  238.  
  239.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._p_e_r_f_o_r_m_e_r
  240.             Performer OpenGL DSOs (n64)
  241.  
  242.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_O_3_2._c_o_m_m_o_n__p_e_r_f_o_r_m_e_r
  243.             Performer GL-independent DSOs (o32)
  244.  
  245.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_O_3_2._i_g_l__p_e_r_f_o_r_m_e_r
  246.             Performer IrisGL DSOs (o32)
  247.  
  248.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_O_3_2._o_g_l__p_e_r_f_o_r_m_e_r
  249.             Performer OpenGL DSOs (o32)
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.        2.3  _I_R_I_S__P_e_r_f_o_r_m_e_r__E_O_E__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s
  273.  
  274.        This section lists the subsystems (and their sizes) of the
  275.        IRIS Performer option.
  276.  
  277.        If you are installing this option for the first time, the
  278.        subsystems marked ``default'' are the ones that are
  279.        installed if you use the ``go'' menu item.  To install a
  280.        different set of subsystems, use the ``install,''
  281.        ``remove,'' ``keep,'' and ``step'' commands in _s_w_m_g_r or _i_n_s_t
  282.        to customize the list of subsystems to be installed, then
  283.        select the ``go'' action.
  284.  
  285.        Note:  The listed subsystem sizes are approximate. Refer to
  286.               the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
  287.               on finding exact sizes.
  288.  
  289.        Subsystem Name                                  Subsystem Size
  290.                                                        (1k-byte blocks)
  291.  
  292.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._d_a_t_a (default)                    8588
  293.        _p_e_r_f_o_r_m_e_r__d_e_m_o._d_a_t_a._t_o_w_n (default)                    5855
  294.        _p_e_r_f_o_r_m_e_r__d_e_m_o._m_a_n._d_e_m_o (default)                       23
  295.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_3_2._i_g_l__d_e_m_o (default)                 563
  296.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_3_2._o_g_l__d_e_m_o (default)                1039
  297.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_6_4._d_e_m_o                              1145
  298.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_O_3_2._i_g_l__d_e_m_o                          577
  299.        _p_e_r_f_o_r_m_e_r__d_e_m_o._s_w_O_3_2._o_g_l__d_e_m_o                         1061
  300.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_3_2._p_e_r_f_o_r_m_e_r_2__0                  15094
  301.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_3_2._p_e_r_f_o_r_m_e_r_2__1                  17045
  302.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_6_4._p_e_r_f_o_r_m_e_r_2__0                   8944
  303.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_6_4._p_e_r_f_o_r_m_e_r_2__1                  10445
  304.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_O_3_2._p_e_r_f_o_r_m_e_r_1__2                  2114
  305.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_O_3_2._p_e_r_f_o_r_m_e_r_2__0                 14037
  306.        _p_e_r_f_o_r_m_e_r__e_o_e._c_o_m_p_a_t_O_3_2._p_e_r_f_o_r_m_e_r_2__1                 15452
  307.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._c_o_m_m_o_n__p_e_r_f_o_r_m_e_r (default)          345
  308.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._i_g_l__p_e_r_f_o_r_m_e_r (default)           19193
  309.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_3_2._o_g_l__p_e_r_f_o_r_m_e_r (default)           19397
  310.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_6_4._p_e_r_f_o_r_m_e_r                         22029
  311.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_O_3_2._c_o_m_m_o_n__p_e_r_f_o_r_m_e_r                   383
  312.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_O_3_2._i_g_l__p_e_r_f_o_r_m_e_r                    17046
  313.        _p_e_r_f_o_r_m_e_r__e_o_e._s_w_O_3_2._o_g_l__p_e_r_f_o_r_m_e_r                    17337
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.                                   - 6 -
  334.  
  335.  
  336.  
  337.        2.4  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  338.  
  339.        All of the IRIS Performer subsystems can be installed using
  340.        IRIX.  You do not need to use the miniroot.  Refer to the
  341.        _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for complete installation
  342.        instructions. Detailed information about both the _s_w_m_g_r and
  343.        _i_n_s_t installation management tools is available through the
  344.        _m_a_n and _x_m_a_n commands.
  345.  
  346.  
  347.        2.5  _C_o_m_p_a_t_i_b_i_l_i_t_y
  348.  
  349.        This distribution contains the IRIS Performer 2.2.5
  350.        execution environment which also contains compatibility
  351.        subsystems with bug fixes for previous versions of IRIS
  352.        Performer.  Applications compiled with the IRIS Performer
  353.        2.0 or 2.1 DSOs will run unmodified with these new IRIS
  354.        Performer 2.0.7 and 2.1.5 DSOs, respectively, across all SGI
  355.        platforms.  The IRIS Performer DSOs are versioned so DSOs
  356.        from multiple versions of IRIS Performer can co-exist and
  357.        applications will automatically run with their proper
  358.        version.
  359.  
  360.  
  361.        2.6  _I_n_s_t_a_l_l_a_t_i_o_n__L_o_c_a_t_i_o_n_s
  362.  
  363.  
  364.        The IRIS Performer execution environment places the base and
  365.        utility library DSOs under "/_u_s_r/_l_i_b, /_u_s_r/_l_i_b_3_2, _a_n_d
  366.        /_u_s_r/_l_i_b_6_4".  The compiled versions of the database loading
  367.        libraries are placed under "/_u_s_r/_l_i_b/_l_i_b_p_f_d_b,
  368.        /_u_s_r/_l_i_b_3_2/_l_i_b_p_f_d_b, _a_n_d /_u_s_r/_l_i_b_6_4/_l_i_b_p_f_d_b".  It is these
  369.        libraries that are dynamically loaded and which must be
  370.        accessible for Performer applications to successfully
  371.        execute.
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.